home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
CP/M
/
CPM_CDROM.iso
/
commodor
/
kermit2.sda
/
KERMIT 5.DOC
< prev
next >
Wrap
Text File
|
1993-05-20
|
13KB
|
463 lines
├-64/128 ╦ERMIT ╒SER'S ╟UIDE ╨AGE 23
╦ERMIT-65>QUIT
╥ECEIVE
╘HE ╥┼├┼╔╓┼ COMMAND CAUSES ├-64/128 ╦ERMIT TO WAIT FOR THE
REMOTE ╦ERMIT TO INITIATE A FILE TRANSFER (USING A COMMAND
LIKE ╙┼╬─). ╘HE FORMAT FOR THIS COMMAND IS:
╦ERMIT-65>RECEIVE [FILENAME]
WHERE [FILENAME] IS ANY VALID ├┬═ ─╧╙ FILE NAME NOT CONTAIN-
ING SPACES. ╔F NO FILE NAME IS GIVEN, ├-64/128 ╦ERMIT WILL
WAIT FOR A FILE TRANSFER INITIALIZATION SEQUENCE FROM THE
OTHER ╦ERMIT. ╔F A FILE NAME IS GIVEN, THAT FILE NAME WILL
BE USED TO STORE THE RECEIVED FILE(S), REGARDLESS OF WHAT
NAME IS SUPPLIED BY THE OTHER ╦ERMIT. ╔F MORE THAN ONE FILE
IS RECEIVED, THE SECOND FILE WILL HAVE A ".00" APPENDED TO
IT. ╘HE THIRD FILE WILL HAVE A ".01", AND SO ON. ╘HE FILE
NAME WILL BE TRUNCATED APPROPRIATELY TO ACCOMMODATE THE
".╪╪" SUFFIX. ╔F ╞╔╠┼-╫┴╥╬╔╬╟ IS TURNED ╧╞╞, THE ".╪╪" SUF-
FIX SCHEME WILL NOT BE USED-- TRANSMISSION WILL STOP WITH
DISK ERROR 63, ╞╔╠┼ ┼╪╔╙╘╙.
╙OME EXAMPLES:
╦ERMIT-65>RECEIVE
╦ERMIT-65>RECEIVE MYFILE
╥ESTORE
╘HE ╥┼╙╘╧╥┼ COMMAND IS USED TO RE-INITIALIZE ╦ERMIT PARAME-
TERS THAT HAVE BEEN PREVIOUSLY SAVED WITH THE ╙┴╓┼ COMMAND.
╦ERMIT SEARCHES THE DISK IN DEVICE 8 FOR A FILE NAMED
╦┼╥═╔╘.╔╬╔. ╔F THIS FILE IS PRESENT ON DISK, ╦ERMIT LOADS
THE PARAMETERS CONTAINED THEREIN AND RESTARTS ITSELF WITH
THOSE NEW PARAMETERS. ╔F NO ╦┼╥═╔╘.╔╬╔ FILE IS FOUND, ╦ER-
MIT CRASHES, EXITING TO ┬┴╙╔├. ┘OU MUST INSERT A DISK CON-
TAINING A ╦┼╥═╔╘.╔╬╔ FILE IN ORDER TO RESTART ╦ERMIT.
╥┼╙╘╧╥┼ HAS NO ARGUMENTS, WITH THE COMMAND FORMAT:
╦ERMIT-65>RESTORE
╙AVE
╘HE ╙┴╓┼ COMMAND SAVES TO THE DISK IN DEVICE 8 THE CURRENT
╦ERMIT SETTINGS AND PARAMETERS IN THE FILE ╦┼╥═╔╘.╔╬╔. ╔F A
╦┼╥═╔╘.╔╬╔ ALREADY EXISTS ON THE DISK, NO ATTEMPT IS MADE TO
WRITE OVER THE EXISTING FILE. ╘HE BLINKING RED LIGHT ON THE
DISK DRIVE INDICATES ERROR #63, ╞╔╠┼ ┼╪╔╙╘╙. ╔T CAN BE
SCRATCHED USING THE ─╔╙╦ COMMAND, HOWEVER. ╘HE PARAMETERS
MAY LATER BE RECALLED WITH THE ╥┼╙╘╧╥┼ COMMAND. ╙┴╓┼ HAS NO
ARGUMENTS, WITH THE FORMAT:
╨AGE 24 ├-64/128 ╦ERMIT ╒SER'S ╟UIDE
╦ERMIT-65>SAVE
╙END
╘HE ╙┼╬─ COMMAND ALLOWS YOU TO SEND A FILE TO THE REMOTE
╦ERMIT. ╘HE COMMAND FORMAT IS:
╦ERMIT-65>SEND [FILENAME]
WHERE [FILENAME] IS ANY VALID ├┬═ ─╧╙ FILENAME. ╨LEASE NOTE
THAT THE ├-64/128 CURRENTLY DOES NOT HAVE A WILDCARD SEND
CAPABILITY. ╔N OTHER WORDS, THE ENTIRE FILE NAME MUST BE
SPECIFIED-- NO PATTERN MATCHING IS ALLOWED. ┴LSO, ONLY ONE
FILE MAY BE SENT PER ╙┼╬─ COMMAND.
╙ET
╘HE ╙┼╘ COMMAND IS USED TO ALTER VARIOUS ╦ERMIT PARAMETERS.
╘HE FORMAT OF THIS COMMAND IS:
╦ERMIT-65>SET [OPTION] [SUBOPTION]...
WHERE [OPTION] IS ONE OF THE FOLLOWING:
┬AUD ┬OLD ┬ORDER
├HARACTER ─ARK-BACKGROUND ─EBUGGING
┼IGHT-BIT-QUOTING ┼SCAPE ╞ILE-BYTE-SIZE
╞ILE-TYPE ╞ILE-WARNING ╞LOW-CONTROL
╔┬═ ╠IGHT-BACKGROUND ╠OCAL-ECHO
╨ARITY ╥ECEIVE ╥╙232-REGISTERS
╙CREEN-DRIVER ╙END ╘ERMINAL-EMULATION
╫ORD-SIZE
═ANY OF THE ABOVE OPTIONS HAVE SUB-OPTIONS. ┴ DESCRIPTION
OF THE OPTIONS AND SUB-OPTIONS FOLLOWS.
╙ET ┬AUD
╘HE ╙┼╘ ┬┴╒─ COMMAND IS USED TO SET THE SPEED AT WHICH COM-
MUNICATIONS WILL TAKE PLACE. ╘HE FORMAT IS:
╦ERMIT-65>SET BAUD [VALUE]
WHERE [VALUE] IS ONE OF THE FOLLOWING:
300 1200 2400
╨LEASE NOTE THAT COMMUNICATION SPEEDS ABOVE 1200 ARE POSSI-
BLE ╧╬╠┘ ON A ├-128 WHEN USING THE ├╧══╧─╧╥┼-128 SCREEN
DRIVER. ┬ECAUSE OF HARDWARE LIMITATIONS, SPEEDS ABOVE 1200
BAUD ARE NOT POSSIBLE ON A ├-64. ┴LSO, PLEASE NOTE THAT
THIS COMMAND DOES NOT SUPPORT SPEEDS UNDER 300 BPS. ┘OU
├-64/128 ╦ERMIT ╒SER'S ╟UIDE ╨AGE 25
WILL NEED TO USE THE ╙┼╘ ╥╙232-╥┼╟╔╙╘┼╥╙ COMMAND INSTEAD.
╙EE THE ╙┼╘ ╥╙232-╥┼╟╔╙╘┼╥╙ SECTION AND THE ╦NOWN ╥ESTRIC-
TIONS SECTION OF ┴PPENDIX ┴ FOR FURTHER INFORMATION.
╙ET ┬OLD
╘HE ╙┼╘ ┬╧╠─ COMMAND SETS THE BOLD CHARACTER COLOR, WHICH
CAN BE USED FOR HIGHLIGHTING TEXT IN ╓╘-100 EMULATION MODE.
┴N EXAMPLE OF BOLD TEXT IS THE "╘YPE ? FOR HELP" MESSAGE
WHEN ╦ERMIT BOOTS. ╘HE DEFAULT BOLD COLOR IS WHITE. ╘HE
FORMAT OF THIS COMMAND IS:
╦ERMIT-65>SET BOLD [COLOR]
WHERE [COLOR] IS ONE OF THE FOLLOWING:
┬LACK ┬LUE ┬ROWN
├YAN ─ARK-GREY ╟REEN
╠IGHT-BLUE ╠IGHT-GREEN ╠IGHT-GREY
╠IGHT-RED ═EDIUM-GREY ╧RANGE
╨URPLE ╥ED ╫HITE
┘ELLOW
╟ENERAL ╬OTES ON ├OLOR
╘HE ABOVE COLORS CORRESPOND TO THE ├-64 ╓╔├ CHIP COLORS. ┴
CLOSEST MAPPING WAS DONE FOR THE ├-128 8563 ╓─├ (THE 80-
COLUMN CHIP) ┬╒╘: 1) ORANGE IS REALLY A DARK PURPLE WHILE 2)
MEDIUM-GREY HAS A GREENISH TINT. ┴LSO, NOTE THAT:
1) ╘HE ├-128 DISPLAY HAS NO BORDER (JUST LIKE A REAL ╓╘-
100).
2) ╘HE ┬╔-80 HAS NO COLOR OPTIONS OR BORDER-- AND, ANY
HIGHLIGHTED TEXT IS PRINTED AS REVERSE.
3) ╬ONE OF THE ╙┼╘ COMMANDS FOR COLOR CURRENTLY HAVE A
CORRESPONDING ╙╚╧╫ COMMAND.
┴ REAL ╓╘-100 TERMINAL DOESN'T HAVE ANY COLOR OPTIONS AT
ALL-- SIMPLY LIGHT TEXT ON A DARK BACKGROUND, OR VICE VERSA.
╙O, MOST OF ╦ERMIT'S SCREEN DRIVERS GIVE YOU AN ADDED CAPA-
BILITY WITH THEIR COLOR OPTIONS.
╙ET ┬ORDER
╘HE ╙┼╘ ┬╧╥─┼╥ COMMAND SETS THE BORDER COLOR, WHICH IS
AVAILABLE ONLY WHEN USING THE ├-64 40 OR 80 COLUMN SCREEN
DRIVERS. ╘HE DEFAULT BORDER COLOR IS BLUE. ╘HE FORMAT OF
THIS COMMAND IS:
╦ERMIT-65>SET BORDER [COLOR]
WHERE [COLOR] IS ONE OF THE COLORS LISTED UNDER THE "╙ET
╨AGE 26 ├-64/128 ╦ERMIT ╒SER'S ╟UIDE
┬OLD" SECTION.
╙ET ├HARACTER
╘HE ╙┼╘ ├╚┴╥┴├╘┼╥ COMMAND SETS THE NORMAL CHARACTER COLOR.
╘HE DEFAULT CHARACTER COLOR IS BLACK. ╘HE FORMAT FOR THIS
COMMAND IS:
╦ERMIT-65>SET CHARACTER [COLOR]
WHERE [COLOR] IS ONE OF THE COLORS LISTED UNDER THE "╙ET
┬OLD" SECTION.
╙ET ─ARK-BACKGROUND
╘HE ╙┼╘ ─┴╥╦-┬┴├╦╟╥╧╒╬─ COMMAND SETS THE ╓╘-100 DARK BACK-
GROUND COLOR (THE ONE NORMALLY USED). ╘HIS IS ALSO THE
BACKGROUND COLOR USED IN ╓╘-52 MODE OR WHEN NO TERMINAL EMU-
LATION IS USED. ╘HE DEFAULT DARK-BACKGROUND COLOR IS
MEDIUM-GREY. ╘HE FORMAT FOR THIS COMMAND IS:
╦ERMIT-65>SET DARK-BACKGROUND [COLOR]
WHERE [COLOR] IS ONE OF THE COLORS LISTED UNDER THE "╙ET
┬OLD" SECTION.
╙ET ─EBUGGING
╘HE ╙┼╘ ─┼┬╒╟╟╔╬╟ COMMAND IS USED TO SET THE TYPE OF DEBUG-
GING GENERATED BY ├-64/128 ╦ERMIT DURING A FILE TRANSFER.
╘HE FORMAT IS:
╦ERMIT-65>SET DEBUGGING [KEYWORD]
WHERE [KEYWORD] IS EITHER ╧╞╞, ╘┼╥╙┼, OR ╓┼╥┬╧╙┼. ╧╞╞
CAUSES ALL DEBUGGING OUTPUT TO BE SUPPRESSED. ╘┼╥╙┼ DIRECTS
A COPY OF EACH PACKET TO THE SCREEN, PRINTING ANY CONTROL
CHARACTERS AS <├╘╥╠> - <"CHAR">. ╓┼╥┬╧╙┼ PRINTS IDENTIFYING
TEXT FOR EACH FIELD IN THE HEADER AND PRINTS THE ACTUAL DATA
SECTION OF THE PACKET IN THE SAME MANNER ╘┼╥╙┼ USES.
╙ET ┼IGHT-BIT-QUOTING
╘HIS COMMAND TURNS ON OR TURNS OFF THE EIGHT-BIT-QUOTING
FEATURE. ┼IGHT BIT QUOTING IS USED TO TRANSMIT EIGHT-BIT
BYTES OVER A SEVEN-BIT DATA PATH. ╔F THE ╫╧╥─-╙╔┌┼ IS
╙┼╓┼╬-┬╔╘, EIGHT BIT QUOTING ALLOWS FULL EIGHT-BIT DATA TO
STILL BE TRANSMITTED. ╔F THE ╫╧╥─-╙╔┌┼ IS ┼╔╟╚╘-┬╔╘, THE
QUOTING IS IGNORED AS IT IS NOT NEEDED. ╘HE FORMAT OF THE
COMMAND IS:
╦ERMIT-65>SET EIGHT-BIT-QUOTING [KEYWORD]
├-64/128 ╦ERMIT ╒SER'S ╟UIDE ╨AGE 27
WHERE [KEYWORD] IS ╧╬ OR ╧╞╞.
╙ET ┼SCAPE
╘HIS COMMAND SETS THE ESCAPE CHARACTER, WHICH IS THE CHARAC-
TER USED TO "ESCAPE" BACK TO ├OMMAND ═ODE FROM ├ONNECT ═ODE.
╘HE COMMAND TAKES A HEXADECIMAL VALUE OF THE CHOSEN CHARAC-
TER TO USE AS THE ESCAPE CHARACTER. ╘HE DEFAULT CHARACTER
IS <├╘╥╠> - <┘> ($19). ╔T IS USUALLY A GOOD IDEA TO SET
THIS CHARACTER TO SOMETHING WHICH IS NOT USED (OR AT LEAST
NOT USED VERY OFTEN) ON THE SYSTEM TO WHICH ├-64/128 ╦ERMIT
IS CONNECTED. ╘HE FORMAT OF THE COMMAND IS:
╦ERMIT-65>SET ESCAPE [HEX VALUE]
WHERE [HEX VALUE] IS THE ┴╙├╔╔ VALUE, IN HEX, OF THE CHARAC-
TER TO USE AS THE ESCAPE CHARACTER.
╙ET ╞ILE-BYTE-SIZE
╘HIS COMMAND SETS THE BYTE SIZE ├-64/128 ╦ERMIT WILL USE FOR
FILES BEING RECEIVED OR TRANSMITTED. ╘HE FILE BYTE SIZE CAN
ALMOST ALWAYS BE ┼╔╟╚╘-┬╔╘, AS THIS SETTING WILL WORK FOR
MOST ╙┼╓┼╬-┬╔╘ AND ┼╔╟╚╘-┬╔╘ DATA FILES. ╘HE FORMAT OF THIS
COMMAND IS:
╦ERMIT-65>SET FILE-BYTE-SIZE [SIZE]
WHERE [SIZE] IS ╙┼╓┼╬-┬╔╘ OR ┼╔╟╚╘-┬╔╘.
╙ET ╞ILE-TYPE
╘HIS COMMAND TELLS ╦ERMIT WHAT TYPE OF FILE IS BEING SENT OR
RECEIVED. ╔T IS IMPORTANT THAT THIS PARAMETER BE SET
CORRECTLY SINCE IT IS USED TO DETERMINE THE EXACT FILE
LENGTH WHEN SENDING FILES IN ADDITION TO DETERMINING SPECIAL
PROCESSING WHICH MAY HAVE TO BE DONE (I.E. WHEN RECEIVING A
TEXT FILE, WRITE ALL CHARACTERS IN ╨┼╘╙├╔╔). ╘HE FORMAT OF
THIS COMMAND IS:
╦ERMIT-65>SET FILE-TYPE [TYPE]
WHERE [TYPE] IS ┴╙├╔╔, ┬╔╬┴╥┘, ├-╨╧╫┼╥, ╨┼╘╙├╔╔, OR ╙├╥╔╨╘.
┴N ┴╙├╔╔ TYPE FILE IS ANY STANDARD ┴╙├╔╔ TEXT FILE. ┴
┬╔╬┴╥┘ TYPE FILE IS A MEMORY IMAGE (I.E. MACHINE LANGUAGE
PROGRAM, GRAPHICS SCREEN, ETC.) AND IS NORMALLY TRANSFERRED
IN EIGHT-BIT MODE. ┴ ├-╨╧╫┼╥ TYPE FILE IS A ├ LANGUAGE
SOURCE FILE FOR USE WITH THE ├ ╨OWER ├ COMPILER FROM ╨RO-
╠INE (NOW SOLD AS ╨OWER ├ BY ╙PINNAKER). ┴ ╨┼╘╙├╔╔ TYPE
FILE IS A ├┬═ ┴╙├╔╔ TEXT FILE. ┴ ╙├╥╔╨╘ TYPE FILE IS A FILE
PRODUCED BY THE ╙PEEDSCRIPT WORD PROCESSOR PUBLISHED BY ├OM-
╨AGE 28 ├-64/128 ╦ERMIT ╒SER'S ╟UIDE
PUTE! ╨UBLICATIONS.
╙ET ╞ILE-WARNING
╘HIS COMMAND DETERMINES WHAT ├-64/128 ╦ERMIT WILL DO WHEN IT
RECEIVES A FILE WITH A FILENAME THAT ALREADY EXISTS. ╔F
╞╔╠┼-╫┴╥╬╔╬╟ IS TURNED ╧╬, ├-64/128 ╦ERMIT WILL NOT
OVERWRITE THE OLD FILE. ╔NSTEAD, IT WILL CREATE A FILE WITH
THE ORIGINAL FILE NAME WITH A ".00" APPENDED TO IT. ╔T WILL
INCREMENT THE ".╪╪" NUMBER UNTIL IT SUCCEEDS IN CREATING A
UNIQUE FILE NAME. ╔F ╞╔╠┼-╫┴╥╬╔╬╟ IS TURNED ╧╞╞, ├-64/128
╦ERMIT WILL STOP WITH DISK ERROR 63, ╞╔╠┼ ┼╪╔╙╘╙. ╘HE FOR-
MAT OF THIS COMMAND IS:
╦ERMIT-65>SET FILE-WARNING [KEYWORD]
WHERE [KEYWORD] IS EITHER ╧╬ OR ╧╞╞.
╙ET ╞LOW-CONTROL
╘HE ╙┼╘ ╞╠╧╫-├╧╬╘╥╧╠ COMMAND ENABLES OR DISABLES ╪╧╬/╪╧╞╞
FLOW CONTROL. ╫ITH FLOW CONTROL ON, ├-64/128 ╦ERMIT WILL
AUTOMATICALLY SEND A <├╘╥╠> - <╙> TO THE HOST COMPUTER WHEN
IT CAN'T KEEP UP (I.E. BUFFER FULL) TO PREVENT LOSS OF CHAR-
ACTERS. ╦ERMIT WILL THEN SEND A <├╘╥╠> - <╤> WHEN IT IS
READY TO RECEIVE MORE DATA. ╘HIS OPTION IS RECOMMENDED FOR
COMMUNICATION SPEEDS OF 1200 BAUD OR HIGHER. ╘HE FORMAT OF
THIS COMMAND IS:
╦ERMIT-65>SET FLOW-CONTROL [KEYWORD]
WHERE [KEYWORD] IS EITHER ╧╬ OR ╧╞╞.
╙ET ╔┬═
╘HE ╙┼╘ ╔┬═ COMMAND SETS UP ├-64/128 ╦ERMIT TO COMMUNICATE
WITH CERTAIN ╔┬═ MAINFRAMES. ╘HIS COMMAND IS NEEDED ON A
LIMITED NUMBER OF SYSTEMS. ╘HE FORMAT OF THIS COMMAND IS:
╦ERMIT-65>SET IBM [KEYWORD]
WHERE [KEYWORD] IS EITHER ╧╬ OR ╧╞╞. ╫ITH ╔┬═ MODE ON, ├-
64/128 ╦ERMIT WAITS FOR THE ╔┬═ TURNAROUND CHARACTER (╪╧╬,
<├╘╥╠> - <╤>) BEFORE SENDING ANY CHARACTERS TO THE OTHER
╦ERMIT. ╔T ALSO FORCES THE PARITY TYPE TO BE MARK, THE WORD
LENGTH TO BE SEVEN-BIT, TURNS ON LOCAL ECHO FOR THE ├╧╬╬┼├╘
COMMAND AND TURNS OFF FLOW-CONTROL. ┴LL OF THESE CHANGES
ARE TEMPORARY. ╫HEN ╔┬═ MODE IS TURNED OFF, ANY PARAMETERS
├-64/128 ╦ERMIT ╒SER'S ╟UIDE ╨AGE 29
ALTERED ARE RETURNED TO THEIR PREVIOUS VALUES.
╙ET ╠IGHT-BACKGROUND
╘HE ╙┼╘ ╠╔╟╚╘-┬┴├╦╟╥╧╒╬─ COMMAND SETS THE ╓╘-100 LIGHT BACK-
GROUND COLOR (THE ONE NOT NORMALLY USED). ╘HE LIGHT BACK-
GROUND IS GENERALLY USED ONLY BY PROGRAMS TO CATCH YOUR
ATTENTION (USUALLY BY FLASHING THE BACKGROUND COLOR
QUICKLY). ╘HE DEFAULT LIGHT-BACKGROUND COLOR IS LIGHT-GREY.
╘HE FORMAT FOR THIS COMMAND IS:
╦ERMIT-65>SET LIGHT-BACKGROUND [COLOR]
WHERE [COLOR] IS ONE OF THE COLORS LISTED UNDER THE "╙ET
┬OLD" SECTION.
╙ET ╠OCAL-ECHO
╘HE ╙┼╘ ╠╧├┴╠-┼├╚╧ COMMAND SPECIFIES WHETHER CHARACTERS
SHOULD BE ECHOED LOCALLY WHEN CONNECTED TO ANOTHER COMPUTER.
╔F ╠╧├┴╠-┼├╚╧ IS SET ╧╬, ANY CHARACTER TYPED ON THE ├-64/128
WILL BE ECHOED IMMEDIATELY TO THE ├-64/128 AS WELL AS BEING
SENT TO THE OTHER COMPUTER. ╘HIS SETUP IS USEFUL WHEN YOU
ARE CONNECTED TO ANOTHER PERSONAL COMPUTER. ╔F ╠╧├┴╠-┼├╚╧
IS SET ╧╞╞, THE CHARACTERS TYPED ON THE ├-64/128 ARE SENT
ONLY TO THE OTHER COMPUTER (WHICH WOULD NORMALLY ECHO THE
CHARACTERS). ╘HIS ARRANGEMENT IS USED BY MOST MAINFRAME
HOSTS. ╘HE FORMAT OF THIS COMMAND IS:
╦ERMIT-65>SET LOCAL-ECHO [KEYWORD]
WHERE [KEYWORD] IS EITHER ╧╬ OR ╧╞╞.
╙ET ╨ARITY
╘HIS COMMAND DETERMINES THE TYPE OF PARITY TO USE DURING
COMMUNICATION. ╦ERMIT NORMALLY USES CHARACTERS WHICH CON-
SIST OF EIGHT DATA BITS WITH NO PARITY BIT. ╞OR SYSTEMS OR
TRANSMISSION MEDIA WHICH REQUIRE A SPECIFIC PARITY TYPE,
╦ERMIT CAN SEND CHARACTERS AS SEVEN DATA BITS PLUS A PARITY
BIT. ╘HE FORMAT OF THIS COMMAND IS:
╦ERMIT-65>SET PARITY [KEYWORD]
WHERE [KEYWORD] IS ONE OF THE FOLLOWING: